Inside Macintosh: QuickTime Components /

Chapter 8 - Video Digitizer Components / Video Digitizer Components Reference

Video Digitizer Component Functions / Getting Information About Video Digitizer Components

VDGetCurrentFlags

The VDGetCurrentFlags function returns status information about a specified video digitizer component.

All video digitizer components must support this function.

pascal VideoDigitizerError VDGetCurrentFlags 
                                    (VideoDigitizerComponent ci,
                                     long *inputCurrentFlag, 
                                     long *outputCurrentFlag);

ci

Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.

inputCurrentFlag

Contains a pointer to a long integer that is to receive the current input state flags for the video digitizer component. The VDGetCurrentFlags function returns the current input state flags into this location. See "Current Flags" on page 8-19 for a complete description of these flags.

outputCurrentFlag

Contains a pointer to a long integer that is to receive the current output state flags for the video digitizer component. The VDGetCurrentFlags function returns the current output state flags into this location. See "Current Flags" on page 8-19 for a complete description of these flags.

DESCRIPTION

The VDGetCurrentFlags function returns the status information into two fields that contain flags specifying the current input and output status of the digitizer component.

You can also use the VDGetDigitizerInfo function (described in the previous section) in your application to retrieve capability and current status information about a video digitizer component.

The VDGetCurrentFlags function is often more convenient than the VDGetDigitizerInfo function. For example, this function provides a simple mechanism for determining whether a video digitizer is receiving a valid input signal. An application can retrieve the current input state flags and test the high-order bit by examining the sign of the returned value. If the value is negative (that is, the high-order bit, digiInSignalLock, is set to 1), the digitizer component is receiving a valid input signal.

RESULT CODE

noErr

0

No error

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help